Inside Macintosh: QuickTime /

Chapter 2 - Movie Toolbox / Movie Toolbox Reference

Functions for Getting and Playing Movies / Preferred Movie Settings

GetMoviePreferredRate

The GetMoviePreferredRate function returns a movie's default playback rate. This is the rate that the StartMovie function uses when it starts playing a movie.

pascal Fixed GetMoviePreferredRate (Movie theMovie);

theMovie

Specifies the movie for this operation. Your application obtains this movie identifier from such functions as NewMovie, NewMovieFromFile, and NewMovieFromHandle (described on page 2-80, page 2-76, and page 2-78, respectively).

DESCRIPTION

The GetMoviePreferredRate function returns the default movie rate as a 32-bit, fixed-point number. Positive integers indicate forward rates and negative integers indicate reverse rates.

ERROR CODES

invalidMovie

-2010

This movie is corrupted or invalid

SEE ALSO

Your application can change the preferred playback rate by calling the SetMoviePreferredRate function, which is described in the previous section. You can change the current playback rate of a movie by calling the SetMovieRate function, which is described on page 2-172.